home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / qkbira21.zip / QKBIRA.DOC < prev    next >
Text File  |  1990-12-16  |  5KB  |  106 lines
  1.                   QKBImodemRemoteAccess Interface v2.0
  2.  
  3.          (c) Copyright 1990, Christopher Hall - Albuquerque, NM
  4.                           All Rights Reserved
  5.  
  6.                             Christopher Hall
  7.                            6067 McKinney, NE
  8.                         Albuquerque, NM   87109
  9.                              (505)821-5341
  10.                             FidoNet 1:301/2
  11.                           CompuServe 72150,752
  12.  
  13. ----------------------------------------------------------------------------
  14.  
  15. Introduction:
  16.  
  17.   I recently converted my system over to the Remote Access BBS package
  18. after quite a few years running QuickBBS.  I won't go into the details
  19. as to why.  Anyway, since I already had a standard QuickBBS to Bimodem
  20. Interface (QkBiLog) I decided it would be easy to switch over and adapt
  21. the existing code for Remote Access.  QkBiRa is the result of that
  22. conversion.
  23.  
  24.   I've never liked having to run Bimodem through an external protocol
  25. selection since the user should already have a Bimodem.Pth file created.
  26. Thus, QkBira is designed to be run either through a Type 7 or Type 15
  27. exit from Remote Access.  Once invoked, QkBira will:
  28.  
  29.      - Read the ExitInfo.BBS file and determine all the necessary
  30.        information to pass to Bimodem - Time Remaining, Download Limits,
  31.        etc. are ALL taken into account.
  32.  
  33.      - Read the Limits.Ctl file to determine Download/Upload Ratios.
  34.  
  35.      - Write a QkBiRa.Dir file as specified in the QkBira.Cfg.
  36.        Your Bimodem.Cfg should point to this file in the Filenames and
  37.        Paths section as the "Directory or List of Directories files are
  38.        sent from".  When written, this file reads FILES.RA and enables
  39.        all available file area a user has access to based on security
  40.        level and flag settings.
  41.  
  42.      - Once the transfer is completed, the Files.BBS (or PFile.BBS if
  43.        Private is enabled in the QkBira.Cfg) is updated with
  44.        successfully uploaded filenames and descriptions (and the [x]
  45.        Download counter is placed if Counters is enabled).
  46.  
  47.        If NO descriptions were entered in the user's Bimodem.Pth file,
  48.        the FOSSIL driver is initiated to prompt the user for file
  49.        descriptions. There is a time-out delay if no user activity takes
  50.        place in 5 minutes, as well as, a Carrier Detect routine so that
  51.        QkBiRa will exit and cycle back to the board.
  52.  
  53.      - The ExitInfo.BBS file is updated with all pertinent User stats.
  54.  
  55.      - A Log Entry is written to the RA.LOG.
  56.  
  57.      - A Log Entry is made to the transfer log as specified in the
  58.        Bimodem.Cfg file if Log is enabled in the QkBiRa.Cfg.
  59.  
  60. Note:  Since Bimodem uses the QkBiRA.Dir file for searching for
  61. downloads, etc.  - Users can d/l from ANY file area that they have
  62. access to! See the Bimodem Documentation for details on this feature, as
  63. well as, how to set up the Bimodem.Cfg file.
  64. ----------------------------------------------------------------------
  65.  
  66. Setup:
  67.  
  68.   The easiest setup is simply to:
  69.  
  70.    - UnZip QkBira into your Remote Access system directory.
  71.  
  72.    - Edit the QkBiRa.Cfg file to suit your own configuration.
  73.      (I've found it best to copy the Bimodem.Cfg file over to your RA
  74.      System directory to minimize the command parameter length)
  75.  
  76.    - Add a Menu Option in your File Template to run Bimodem.
  77.      (I use a separate Bimodem.Mnu that gives the caller a second
  78.      chance just in case they hit the Hot Key in error)
  79.  
  80.      Specify a Type 7 Menu with Optional Data as:
  81.      QkBira.Exe QkBiRa.Cfg [Locked Baud Rate]
  82.  
  83. That's all there is to it!
  84.  
  85. Command Syntax:  QkBira [QkBira.Cfg [Locked_Baud_Rate]]
  86.  
  87. If no parameters are given - QkBira.Cfg is assumed.  In order to use a
  88. Locked Baud Rate, the config file name MUST be used.
  89.  
  90. ------------------------------------------------------------------------
  91.  
  92. Thanks go to:
  93.  
  94.    John Erickson   - Bimodem (Phoenix, Az)
  95.    Andrew Milner   - Remote Access (Perth, Australia)
  96.    Ed Meloan       - US Contact for Remote Access (Great Support!)
  97.    Chris Carpenter - My local Beta Tester.
  98.  
  99. ************************** NOTE ****************************************
  100. If you use this program and find it of value, a contribution of $10.00
  101. would be greatly appreciated! In any event, I would appreciate hearing
  102. from any Sysops who are using this program. I can be reached through the
  103. Bimodem Echo or directly through PC Network.
  104. ************************************************************************
  105.  
  106.